home *** CD-ROM | disk | FTP | other *** search
/ The Game Master (3rd Edition) / The Game Master 3rd edition.iso / files / demo_vga / utilega2 / egachg.doc < prev    next >
Encoding:
Text File  |  1986-10-09  |  8.9 KB  |  188 lines
  1.                                     EGACHG.COM
  2.                                Ver. 1.1, Feb 17, 1986
  3.                        Part of the ENHANCER series of programs
  4.  
  5.                      Copyright (C)  I. B. Miller     1985, 1986
  6.  
  7.                If you find this of value and use it please send $25 to
  8.           Enhancers, 231 Otonabee Ave., Willowdale, Ontario, Canada M2M-2S9
  9.  
  10.          It is suggested that companies contribute more for use on more than
  11.          one machine.  Please contact me for a site license.  Phone (416)
  12.          226-9753
  13.  
  14.          EGACHG is a program which provides a means to preset 12 palette
  15.          color combinations for EGACLR.COM a companion program which Controls
  16.          the seventeen palette registers on the enhanced color card (Enhanced
  17.          Graphics Adapter), 12 different user selected color combinations of
  18.          any 16 of the 64 colors available can be made active by use of the
  19.          Alt key at the same time as any of the number keys 1 to = at the top
  20.          of the qwerty keyboard.  EGACHG will change the colors in the
  21.          Palette registers so that you can see what is available but unless
  22.          you use EGACLR these will be lost at the next video reset called by
  23.          any program.
  24.  
  25.          The actual colors available to you depend on your actual hardware
  26.          set up and so may be different.  As an example if you have only a
  27.          regular monitor you will have only standard colors though you will
  28.          be able to swap them around.  In my experience THE limiting factor
  29.          for text display is the monitor.  Though for graphic display memory
  30.          size is also a limiting factor.
  31.  
  32.          General Information
  33.          -------------------
  34.              With the Enhanced Monitor color coding is as follows.
  35.  
  36.                     Bit                            Hex
  37.                     ---                            ---
  38.                       1 is    Medium     Blue     - 01
  39.                       2 is    Medium     Green    - 02
  40.                       3 is    Medium     Red      - 04
  41.                       4 is Low   intensity Blue   - 08
  42.                       5 is Low   intensity Green  - 10
  43.                       6 is Low   intensity Red    - 20
  44.                     1+4 is High  intensity Blue   - 09
  45.                     2+5 is High  intensity Green  - 12
  46.                     3+6 is High  intensity Red    - 24
  47.          Low and medium add to give high - this is the basic principle the
  48.          card works on.
  49.  
  50.             Following is the standard color palette combination.
  51.             ----------------------------------------------------
  52.                        B  B  G  C  R  M  B  W  G High intensity colors O
  53.                        l  l  r  y  e  a  r  h  r --------------------- v
  54.                        a  u  e  a  d  g  o  i  e  B  G  C  R  M  B  W  e
  55.                        c  e  e  n     e  w  t  y  l  r  y  e  a  r  h  r
  56.                        k     n        n  n  e     u  e  a  d  g  o  i  s
  57.                                       t           e  e  n     e  w  t  c
  58.                                       a              n        t  n  e  a
  59.                                                               a        n
  60.          palette
  61.           register # = 0  1  2  3  4  5  6  7  8  9  A  B  C  D  E  F 10
  62.  
  63.  
  64.                                    EGACHG  page 2
  65.  
  66.          "10" really cannot be used in Enhanced Mode because of a seeming bug
  67.          in the EGA.  I cannot believe IBM wanted it that way.  Try it & see.
  68.  
  69.          How the program works
  70.          ---------------------
  71.          The program works by loading in the entire EGACLR.COM file and then
  72.          selecting the color controlling bytes which are all near the start
  73.          as initial values for setting the colors.  It then follows the user
  74.          through the registersets updating them in memory and changing them
  75.          and the colors on display as the user dictates.
  76.  
  77.          Once the user is finished changing colors to his liking and has
  78.          pressed the End key EGACHG first checks to see how high in the
  79.          sequence of possible EGACLR1.COM to EGACLR99.COM exists on the disk.
  80.          once found it increments this and writes out a temporary file.
  81.          After it has succeeded in the write it renames the original
  82.          EGACLR.COM to EGACLR(whatever #).COM and then renames the temporary
  83.          file to EGACLR.COM.  In theory you could change names and have
  84.          almost unlimited numbers of color combinations which can be made
  85.          active by using these variants of EGACLR.COM, but in practice I find
  86.          it adequate to have a few and use the command parameters with
  87.          EGACLR.COM to change <alt 1>
  88.  
  89.          Instructions
  90.          ------------
  91.          EGACHG has been written to work on the EGACLR.COM file on the same
  92.          drive as EGACHG.COM.  Make sure both are present on the same disk.
  93.  
  94.          Important: Unless you use the EGACLR command line to turn off auto
  95.          reset, or have not yet activated EGACLR, then EGACLR will proceed to
  96.          not allow this program to show the colors to you.  You must
  97.          Deactivate (or not start) EGACLR before starting EGACHG.
  98.  
  99.          The program will proceed to load into itself the EGACLR.COM file.
  100.          It will then paint a window on the top half of the screen showing
  101.          the palette colors currently in use with EGACLR use of <Alt 1> which
  102.          I call registerset # 1. The program will next paint the bottom
  103.          window which is the working area and will display the current
  104.          register of the 17 included in the current registerset as well as
  105.          the current value in that register displayed in both decimal and
  106.          Hex.  It will also show the RGB components of the color
  107.          corresponding to that value.
  108.  
  109.          From then on you are in the part of the program that does all the
  110.          work and the following keys are the only ones which will do
  111.          anything.
  112.  
  113.          PgUp  Moves Up one registerset from 1 to 12 then back to 1
  114.          PgDn  Moves Down one registerset from 12 to 1 then back to 12
  115.  
  116.          Up    Moves up one Pallette register from 0 to 16 then back
  117.  
  118.          Dn    Moves Down one Pallette register from 16 to 0 then back
  119.  
  120.          +   Increases value in Pallette register from 0 to 63 then back
  121.  
  122.          -   Decreases value in Pallette register from 63 to 0 then back
  123.  
  124.  
  125.  
  126.                                    EGACHG  page 3
  127.  
  128.          R  Cycles Red component of color off, low, med, high & back
  129.          G  Changes Green component off, low, med, high & back
  130.          B  Changes Blue component off, low, med, high & back
  131.  
  132.          Q  Allows you to quit without creating an output file
  133.  
  134.          S  Standardizes colors In current Registerset
  135.  
  136.          W  writes out a .BAT file to reset colors in Alt 1.
  137.             A sample appears here:
  138.  
  139.          EGACLR 02A,126,202,337,404,505,614,707,818,919,A1A,B1B,
  140.                  C3C,D2D,E36,F3F,s00
  141.  
  142.          End  Writes out all the values to an EGACLR.COM files while saving
  143.                 the previous ones as EGACLR1.COM up to EGACLR99.COM
  144.  
  145.          Use the End key when you have completed your selection. the program
  146.          will then update EGACLR.COM with your selected colors available from
  147.          <alt 1> to <alt =>.
  148.  
  149.          You may then activate the colors by entering at the DOS prompt
  150.                                       EGACLR R
  151.  
  152.          Disclaimer
  153.          ----------
  154.          For obvious reasons the user is totally responsible for use of this
  155.          program and determining that it is suitable for use by him, and he
  156.          uses this program with no warranty from myself.
  157.  
  158.          It should work properly with the EGA from IBM or any card which
  159.          later maintains compatibility with it
  160.  
  161.          This program and EGACLR.COM are used by myself with LOTUS Develop-
  162.          ment programs and work well solving a colors shift bug (or less than
  163.          perfect EGA driver routine) but obviously LOTUS does not support it.
  164.  
  165.          General
  166.          --------
  167.          Again please note that if you have the regular monitor or the
  168.          Enhanced Monitor operating in regular mode none of the non-standard
  169.          colors are available to you!
  170.  
  171.          Of Course
  172.          ----------
  173.          The program EGACHG.COM will allow you to work with many colors and
  174.          see them on screen interactively without any of the work involved in
  175.          remembering all the numbers and color coding schemes.  I believe it
  176.          will make color control easy.
  177.  
  178.                 If you have any comments or suggestions please contact
  179.          me either at Home in the evenings at           (416) 226-9753
  180.          or at the following BBS's   PCanada(pc-1266)   (416) 751-6337
  181.                                          SGV-BBS        (416) 673-0557
  182.  
  183.          I am also on Compuserve as  72167,2563          Ivor B. Miller
  184.  
  185.  
  186.  
  187.  
  188.